package cool.webstudy.admin.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import cool.webstudy.admin.model.dto.user.CreateUserDTO;
import cool.webstudy.admin.model.dto.user.PaginationQueryUserInfoListDTO;
import cool.webstudy.admin.model.dto.user.UpdateUserDTO;
import cool.webstudy.admin.model.dto.user.UserLoginDTO;
import cool.webstudy.admin.model.po.user.UserPO;
import cool.webstudy.admin.model.vo.user.PaginationQueryUserInfoListVO;
import cool.webstudy.admin.model.vo.user.QueryCurrentUserVO;
import cool.webstudy.admin.model.vo.user.QueryUserDetailInfoVO;
import cool.webstudy.admin.model.vo.user.QueryUserRoughInfoVO;

import java.util.List;
import java.util.Map;

/**
 * 
 * @author 莫振双
 * @date 2024/7/14 22:05
 * @description: 用户管理接口
 */
public interface UserService {
    /**
     * @param unCode 用户业务主键
     * @return UserPO 用户信息实体
     * @description: 判断用户是否存在，如果存在，则返回该用户的信息实体
     */
    UserPO isExist(String unCode);
    /**
     * @param dto 登录信息实体类
     * @return String token 令牌
     * @description: 用户登录方法
     */
    String login(UserLoginDTO dto);
    /**
     * @return QueryCurrentUserVO 查询当前用户信息接口响应信息模型
     * @description: 查询当前用户信息
     */
    QueryCurrentUserVO queryCurrentUser();
    /**
     * @param unCode 业务主键
     * @return QueryUserDetailInfoVO 查询用户详细信息接口响应参数模型
     * @description: 查询用户详细信息
     */
    QueryUserDetailInfoVO queryUserDetailInfo(String unCode);
    /**
     * @param dto 创建用户接口请求参数模型
     * @return Boolean 是否成功标识
     * @description: 创建用户
     */
    Boolean createUser(CreateUserDTO dto);
    /**
     * @param dto 更新用户接口请求参数模型
     * @return Boolean 是否成功标识
     * @description: 更新用户
     */
    Boolean updateUser(UpdateUserDTO dto);
    /**
     * @param unCodeList 业务主键列表
     * @return Boolean 是否成功标识
     * @description: 批量删除用户
     */
    Boolean batchDeleteUser(List<String> unCodeList);
    /**
     * @param dto 分页获取信息列表接口请求参数基础模型
     * @return Page<PaginationQueryUserInfoListVO> 分页获取用户信息列表接口响应模型
     * @description: 分页获取用户信息列表
     */
    Page<PaginationQueryUserInfoListVO> paginationQueryUserInfoList(PaginationQueryUserInfoListDTO dto);
    /**
     * @param context 模糊搜索关键词
     * @return List<QueryUserRoughInfoVO> 获取用户粗略信息接口响应信息模型
     * @description: 根据用户名或者账号获取启用用户粗略信息列表
     */
    List<QueryUserRoughInfoVO> queryEnabledUserRoughInfoByUserNameOrAccount(String context);
    /**
     * @return Map<String, String> 获取用户业务主键和用户名映射
     * @description: 获取用户业务主键和用户名映射
     */
    Map<String,String> queryUserUnCodeNameMap();
}
